package com.ruoyi.system.mapper;

import java.util.List;

import org.apache.ibatis.annotations.Param;
import com.ruoyi.common.core.domain.entity.SysDictData;

/**
 * 字典表 数据层
 *
 * @author ruoyi
 */
public interface SysDictDataMapper {
    /**
     * 根据条件分页查询字典数据
     *
     * @param dictData 字典数据信息，用于构建查询条件
     * @return 符合条件的字典数据集合
     */
    public List<SysDictData> selectDictDataList(SysDictData dictData);

    /**
     * 根据字典类型查询字典数据
     *
     * @param dictType 字典类型标识
     * @return 指定类型的字典数据集合
     */
    public List<SysDictData> selectDictDataByType(String dictType);

    /**
     * 根据字典类型和字典键值查询字典标签
     *
     * @param dictType  字典类型标识
     * @param dictValue 字典键值
     * @return 对应的字典标签字符串
     */
    public String selectDictLabel(@Param("dictType") String dictType, @Param("dictValue") String dictValue);

    /**
     * 根据字典数据ID查询详细信息
     *
     * @param dictCode 字典数据唯一标识符（ID）
     * @return 对应ID的字典数据对象
     */
    public SysDictData selectDictDataById(Long dictCode);

    /**
     * 统计指定字典类型下的数据数量
     *
     * @param dictType 字典类型标识
     * @return 该类型下字典数据的数量
     */
    public int countDictDataByType(String dictType);

    /**
     * 通过字典数据ID删除对应的记录
     *
     * @param dictCode 要删除的字典数据ID
     * @return 删除操作影响的行数
     */
    public int deleteDictDataById(Long dictCode);

    /**
     * 批量删除多个字典数据记录
     *
     * @param dictCodes 包含需要删除的字典数据ID数组
     * @return 删除操作影响的总行数
     */
    public int deleteDictDataByIds(Long[] dictCodes);

    /**
     * 插入新的字典数据记录
     *
     * @param dictData 待插入的字典数据对象
     * @return 插入操作影响的行数
     */
    public int insertDictData(SysDictData dictData);

    /**
     * 更新已有的字典数据信息
     *
     * @param dictData 包含更新字段的新字典数据对象
     * @return 更新操作影响的行数
     */
    public int updateDictData(SysDictData dictData);

    /**
     * 当字典类型变更时同步更新相关联的数据
     *
     * @param oldDictType 原始字典类型
     * @param newDictType 新的字典类型
     * @return 更新操作影响的行数
     */
    public int updateDictDataType(@Param("oldDictType") String oldDictType, @Param("newDictType") String newDictType);
}
